Yandex Mediation 통합

Важно

최신 어댑터 버전으로 업데이트해야 합니다(Yandex Mobile Mediation타사 중재 네트워크용 어댑터). 그렇지 않으면 잘못된 어댑터 통합으로 인한 오류가 발생하여 광고가 제공되지 않을 수 있습니다.

모바일 중재는 ML 알고리즘을 사용하여 여러 광고 네트워크의 광고를 자동으로 선택하는 플랫폼으로, 이를 통해 수익을 극대화할 수 있습니다. 모든 설정이 사전 구성되어 있어 각 네트워크를 개별적으로 설정할 필요 없이 즉시 사용할 수 있습니다.

단일 Yandex 네트워크와 함께 Mobile Ads SDK를 사용해왔다면 Yandex Mediation으로의 마이그레이션에는 코드 변경이 필요하지 않습니다. 타사 광고 네트워크의 웹 인터페이스 섹션만 사전 설정하면 됩니다.

Mobile Ads Unity는 Yandex Mobile Ads SDK에 대한 지원이 포함된 Unity3d 게임 플랫폼용 플러그인입니다.

사전 준비

앱을 준비하려면 다음 섹션에 설명된 단계를 수행하세요.

앱 요구 사항

  • 이 SDK를 사용하려면 앱의 대상 API 수준이 31 이상으로 설정되어야 합니다.
  • 모든 유형의 광고를 로드하려면 iOS 버전 13 이상이 필요합니다.
  • Xcode 16.1 이상을 사용합니다.

Yandex Advertising Network 계정에 앱 설정

Yandex Advertising Network에 앱을 등록하는 방법은 다음과 같습니다.

  1. Yandex Advertising Network에 로그인하거나 계정을 등록합니다.
  2. Yandex Advertising Network에 앱을 등록합니다.

통합

Важно

yandex-ads-unity-plugin은 Android 및 iOS 환경에서만 실행됩니다. 현재 Unity 편집기에서는 광고를 로드하거나 표시할 수 없습니다.

통합 방법은 두 가지가 있습니다.

  • 단일 빌드(권장): 모든 사용 가능한 어댑터가 자동으로 연결됩니다.
  • 개별 어댑터 연결: Yandex SDK를 라이트 패키지로 설치하고 적절한 패키지를 사용하여 특정 어댑터를 별도로 연결하세요.

공통 yandex-mobileads-mediation 패키지를 사용하여 모든 사용 가능한 어댑터를 자동으로 연결할 수 있습니다.

  1. 파트너 인터페이스에서 중재를 설정합니다.

  2. yandex-ads-unity-plugin 디렉터리를 다운로드하고 패키지 yandex-mobileads-mediation-7.12.1.unitypackage를 추가합니다. 또한 Google 리졸버를 설치하라는 메시지가 표시됩니다. 이미 프로젝트에 Google 리졸버를 추가한 경우, 확인란을 해제합니다.

    패키지 추가 방법

    필요한 플러그인을 선택하고(Assets → Import Package → Custom Package) Import를 클릭합니다.

  3. Google 리졸버를 사용하여 종속성을 설치합니다. auto-resolve를 활성화하거나 메뉴 항목 Assets → External Dependency Manager → Android Resolver → Resolve를 선택하세요.

  4. Mobile Ads Unity 플러그인을 테스트하려면 yandex-ads-unity-plugin 리포지토리의 samples 디렉터리에 있는 데모 스크립트 중 하나를 사용합니다. 스크립트를 프로젝트 디렉터리에 복사하고 메인 카메라에 Component로 추가합니다.

  5. Google AdMob (ex. AdMob) 네트워크에 대한 추가 설정

    • Android의 경우, File → Build Settings → Android → Player Settings → Publishing Settings → Custom Main Manifest(확인란 선택)를 통해 메인 AndroidManifest.xml 파일을 생성합니다.

      생성된 AndroidManifest.xml 애플리케이션 파일에 com.google.android.gms.ads.APPLICATION_ID라는 이름의 <meta-data> 태그를 사용하여 App ID를 추가합니다.

      <manifest>
          <application>
      <!--...-->
              <meta-data
                  android:name="com.google.android.gms.ads.APPLICATION_ID"
                  android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
      <!--...-->
          </application>
      </manifest>
      
    • iOS용으로 생성된 Xcode 프로젝트에서 키 GADApplicationIdentifierapp ID와 함께 Info.plist 파일에 추가합니다.

      <key>GADApplicationIdentifier</key>
      <string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>
      

    Google App ID를 찾을 수 있는 위치에 대해 자세히 알아보세요.

개별 어댑터를 연결하려면 지원되는 yandex-mobileads-lite-x.x.x.unitypackage 버전으로 패키지를 추가하고 각 어댑터에 대한 특정 지침을 따라 활성화하세요.

  1. 파트너 인터페이스에서 중재를 설정합니다.

  2. yandex-ads-unity-plugin 디렉터리를 다운로드하고 패키지 yandex-mobileads-lite-7.12.1.unitypackage를 추가합니다. 또한 Google 리졸버를 설치하라는 메시지가 표시됩니다. 이미 프로젝트에 Google 리졸버를 추가한 경우, 확인란을 해제합니다.

    패키지 추가 방법

    필요한 플러그인을 선택하고(Assets → Import Package → Custom Package) Import를 클릭합니다.

  3. Google 리졸버를 사용하여 종속성을 설치합니다. auto-resolve를 활성화하거나 메뉴 항목 Assets → External Dependency Manager → Android Resolver → Resolve를 선택하세요.

  4. Mobile Ads Unity 플러그인을 테스트하려면 yandex-ads-unity-plugin 리포지토리의 samples 디렉터리에 있는 데모 스크립트 중 하나를 사용합니다. 스크립트를 프로젝트 디렉터리에 복사하고 메인 카메라에 Component로 추가합니다.

  5. 필요한 어댑터를 적절한 패키지를 사용하여 개별적으로 연결합니다.